home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 11 / CU Amiga Magazine's Super CD-ROM 11 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-06].iso / cucd / online / aemail / aemail.readme < prev    next >
Text File  |  1997-03-20  |  25KB  |  557 lines
  1.  
  2.  
  3.                              AEMAIL.README
  4.  
  5.                             (March 20, 1997)
  6.  
  7. Contained in this archive is version 1.14 of AEMail, an Internet Mail User
  8. Agent (Client), which can be used to retrieve mail fron a POP Server and
  9. send mail to a SMTP server.  It requires AmiTCP, or a TCP/IP stack that
  10. is compatable with AmiTCP, and AmigaDOS 2.1 or later.  AEMail has been
  11. successfully tested with TCP/IP stacks used by AmiTCP, TermiteTCP, and
  12. Miami.
  13.  
  14. AEMail can also be used as a "MailTo" agent in WWW browsers, such as
  15. Voyager and AWeb, which allow the user to specify such an agent for
  16. composing and sending email.
  17.  
  18. This version corrects a number of bugs that were discovered in the
  19. 1.13 version released to AmiNet.  A list of the bugs corrected is given 
  20. in the version history below.
  21.  
  22. --------------------------------------------------------------------------
  23.   WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING
  24. --------------------------------------------------------------------------
  25.  
  26. When you send your first message with any new version AEMail, a special 
  27. "Registration" message will be sent to me.  Besides the normal header
  28. information, the body of this message will contain the following information
  29. (obtained from your configuration file):
  30.  
  31.     Your email address
  32.     Your Real Name
  33.     Your POP3 Server name
  34.     Your SMTP Server name
  35.     Your SMTP Domain Name
  36.     Your editor call
  37.     your Display ID (from the screen mode setting)
  38.     Your Overscan Type (from the screen mode setting)
  39.     Base configuration file name
  40.     Currently active configuration file name
  41.     Mail directory
  42.  
  43. This information is provided to help me determine and debug problems with
  44. AEMail.  Future versions may contain more or less information as the need
  45. arises.
  46.  
  47. Most of the Internet information is public information and can be obtained 
  48. from your service provider.
  49.  
  50. I WILL KEEP THIS INFORMATION IN STRICT CONFIDENCE.  IF YOU DO NOT WANT 
  51. THIS INFORMATION DIVULGED TO ME, DO NOT USE AEMAIL!
  52.                                  -----------------
  53.  
  54. I am including this warning because of concerns expressed to me by some
  55. people.
  56.  
  57. --------------------------------------------------------------------------
  58.   WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING  WARNING
  59. --------------------------------------------------------------------------
  60.  
  61. Later versions of AEMail are planned which will provide:
  62.  
  63.         AREXX Support
  64.         Filtering incoming messages to specified folders
  65.         Asynchronous retrieval of messages from a POP server
  66.         Asynchronous sending of messages to the SMTP server
  67.         faster message display routines
  68.         Built in message editor
  69.         Other features suggested by users
  70.  
  71. AEMAIL is copyright (c) 1996, 1997 by John F. Zacharias, all rights reserved.
  72. This version is "Freeware".  Permission is given to to test and evaluate
  73. the program in return for feedback on the use of the program and reporting
  74. of any bugs encountered.  Later versions will become "shareware".
  75.  
  76. This archive contains the following:
  77.  
  78.         The AEMAIL executable
  79.         The Install_AEMail install script for installing AEMail.
  80.         This AEMAIL.README file
  81.         AEMAIL documentation in the file AEMail.doc (for printing)
  82.         AEMail documentation in AmigaGuide format in the file AEMail.guide
  83.         StartNet and StopNet scripts for Miami
  84.         A sample mailcap file to be used with AmigaDos 3.0 or above
  85.  
  86. Before attempting to use AEMail you should read the documentation in
  87. AEMail.guide AND the INSTALL.TXT file.  After the install process the 
  88. default tool for the AEMail.guide file will be MultiView if you are 
  89. running under 3.0 or later, or AmigaGuide if you are ruinning under 2.1.
  90.  
  91.  
  92.  
  93. AEMAIL, version 1.14, release date: 03/20/97
  94.  
  95. As payment for receiving and using this BETA version of AEMAIL, I would like
  96. any bugs, comments, or suggestions reported to me.  You can send me email at
  97.  
  98.     jzachar@calweb.com
  99.  
  100. A entry will be automatically added to your address book with a nickname of
  101. AEMAIL which can be used for routing email to me.
  102.  
  103. I would appreciate any suggestions that you have for improving AEMAIL.
  104. I will not guarantee that I will accept all suggestions or that I will
  105. necessarily implement them in the next release; however, I do take each
  106. suggestion seriously.  In the past I have implemented a number of suggestions
  107. made by my testers.  I will attempt to respond to each suggestion that is
  108. made.
  109.  
  110. In making suggestions keep in mind some of the restraints that I have placed
  111. on AEMAIL:  (1) The program should be able to be run on any version of
  112. AmigaDos 2.1 or greater, and (2) with the exception of AmiTCP or a TCP/IP
  113. compatible with AmiTCP (TermiteTCP or Miami), AEMAIL should not require any 
  114. extension to your system that does not come with a standard AmigaDOS release.  
  115. This effectively rules out MUI.  Using an editor of your choice meets this 
  116. criteria since you can use the standard AmigaDOS editors, ED or MEMACS, which 
  117. come with the standard Amiga systems.
  118.  
  119. There have been extensive changes made to the documentation and .guide files
  120. for this version and some errors are inconsistancies may have crept in in
  121. the process.  Reports of bugs or inconsistancies in the documentation
  122. are also appreciated.
  123.  
  124. When reporting bugs or making suggestions, please be as complete as possible
  125. in describing the circumstances that brought about the problem or how the
  126. suggestion could be implemented.
  127.  
  128. If you give this program to anyone else to use and evaluate, please include
  129. the complete archive including the readme and documentation files and make
  130. clear to them that this is a prelimary version of the program.
  131.  
  132. An automatic registration procedure has been provided which will automatically
  133. send me an email message the first time any mail is sent from AEMAIL.  This
  134. message will also be sent any time the user upgrades to a new version.
  135.  
  136.  
  137. THE FUTURE
  138.  
  139. This version of AEMail is version 1.13, and is the tenth BETA release.  At
  140. this point it is still under evaluation and is "Freeware" to encourage as
  141. much wide spread use of the program as possible.  This "Freeware" version
  142. can be distributed to any and all BBS's provided the entire archive is kept
  143. intact.
  144.  
  145. I also hope to shortly develop my own "home page" where the latest version
  146. can be obtained.  However, as a user of the program you will receive updates
  147. via email or a notice when a new version is posted to AmiNet.
  148.  
  149. When certain features such as:
  150.  
  151.         AREXX
  152.         Background retrieval and sending of mail.
  153.         Directing retrieval of mail to selected folders.
  154.         Faster mail display.
  155.  
  156. are implemented, AEMAIL will be released as shareware.  When this occurs, a
  157. number of these features will be disabled until the shareware fee is paid.
  158.  
  159. Since the doc file is quite large, I am also considering a printed manual
  160. that will be sent to registered users that pay the shareware fee.  The
  161. availability of this manual may be before the features listed above are
  162. implemented.
  163.  
  164. -John Zacharias
  165.  March 20, 1996
  166.  jzachar@calweb.com
  167.  
  168.                                  VERSION HISTORY
  169.  
  170. Version 1.14    Released March 20, 1997.  Minor correction release.
  171.  
  172.                 Fixed Installation script (Install_AEMail).  It would
  173.                 not properly install AEMail if AEMail had not been
  174.                 installed previously.
  175.  
  176.                 Insured that the Mail directory and the Mailcap
  177.                 directories ended with either ':' or '/'.  If the
  178.                 definitions did not, an '/' was appended to the 
  179.                 path definitions.
  180.  
  181.                 Corrected a problem where the Mailcap directory was
  182.                 being used instead of the Mail directory hor the
  183.                 .header file (this was not apparent in the Mail
  184.                 directory and the Mailcap directory were the same).
  185.  
  186.                 Corrected a problem where the .header file was being
  187.                 read before the configuration file.  This again
  188.                 probably would not have been an apparent problem.
  189.  
  190.                 Corrected a problem with the "Remove DELETED Msgs"
  191.                 menu item in which selecting [CANCEL] would go
  192.                 ahead and delete the messages anyway.  [CANCEL] will
  193.                 now exit without deleting any messages.
  194.  
  195.                 Corrected a problem when AEMail was called from the
  196.                 shell. The "config=" parameter was not working
  197.                 properly.  It now works correctly.
  198.  
  199. Version 1.13    Released March 10, 1997.
  200.  
  201.                 AEMail now allows for multiple configuration files.  The
  202.                 "Project/Configuration" menu item now has five sub-items:
  203.                 "Open", "Edit", "Save", "Save As" and "Restore Default"
  204.                 The old "Save Settings" and "Restore Settings" menu items
  205.                 have been removed.
  206.  
  207.                 A "Save As" button has been added to the Configuration
  208.                 screen.
  209.  
  210.                 To accomodate multiple configurations, the "Mail Directory" 
  211.                 has been removed from the "Paths" Configuration page.  It
  212.                 is still available as a Tool Type, however.
  213.  
  214.                 A CONFIG= Tool Type has been added to allow AEMail to start
  215.                 up with a specified configuration file.
  216.  
  217.                 Miami Start Net and Stop Net scripts have been provided.
  218.  
  219.                 A special CygnusEd script has been provided to properly
  220.                 use CygnusEd (CED) as your editor.
  221.  
  222.                 If a message file is missing, AEMail no longer terminates
  223.                 if you try to access that file.
  224.  
  225.                 A busy pointer has been added to a number of processes.
  226.  
  227.                 When AEMail terminates and you don't want to check for mail,
  228.                 AEMail no longer attempts to access your POP server.  This
  229.                 can result in a requester, however, that states you are online,
  230.                 even when you are not.
  231.  
  232.                 Duplicate hot key menu calls have been eliminated.
  233.  
  234.                 The Install script has been modified to provide for the
  235.                 added configuration items.
  236.  
  237.                 "text/*" and "message/*" have been added to the mailcap
  238.                 file using MultiView (3.x users only).  This allows you to
  239.                 view long text attachments that are not "SHOWN" (see 
  240.                 Version 1.12 enhancement).
  241.  
  242.                 Other minor corrections have been made.
  243.  
  244. Version 1.12    Released February 15, 1997.  This version was a special version
  245.                 without updated documentation or install script.  It was not
  246.                 uploaded to AmiNet.  It featured the following corrections and 
  247.                 enhancements:
  248.  
  249.                 The configuration screens have been totally revamped. Some new 
  250.                 items have been added and others re-named or moved to other
  251.                 configuration 'pages'.  The heading for the "Required" screen 
  252.                 has been changed to "Identity" to more clearly indicate its 
  253.                 purpose and the buttons to call the various configuration 
  254.                 'pages' have been moved to the top of the screen.  When you 
  255.                 select a configuration page, the button for that page will 
  256.                 "light" up and stay "lit" while you are on that page.
  257.  
  258.                 A From: (your email address), Reply To: and Organization
  259.                 item has been added to the "Identity" page.  New Tool Types
  260.                 have also been added to correspond to these items.
  261.  
  262.                 The "Mail Directory:" item has been moved to the "PATHS" page
  263.                 and "Edit Call:" to the "GENERAL" parameter page.
  264.  
  265.                 The TCP Logging File process has been changed to provide
  266.                 additional menu control over the logging file.  A new menu 
  267.                 sub-group called "TCP Logging File" has been added under 
  268.                 the "TCP/IP" menu group.  This sub-group has three menu
  269.                 sub-items called "Active", "Purge", and "Display/Edit...".
  270.  
  271.                 A new checkmarked item is added under the "TCP Logging File:"
  272.                 item in the PATHS page of the configuration screen called 
  273.                 "TCP Logging active on AEMail startup".
  274.  
  275.                 Under the Folders menu group, an item called "Remove DELETED
  276.                 Msgs" has been added.  This will IMMEDIATELY delete ALL messages
  277.                 marked for deletion in the current active folder.
  278.  
  279.                 A new menu item has been added under the "Messages" menu group
  280.                 called "Edit...". 
  281.  
  282.                 When you reply to a message, the compose message routine will
  283.                 first try to send the reply to any "Reply-To:" address that
  284.                 was in the message you are replying to.  If the "Reply-To" 
  285.                 header was not present, it will then send the reply to the 
  286.                 "From:" header address.
  287.  
  288.                 The same applies to transferring addresses to the address book.
  289.                 If you want to transfer the address from a message you are
  290.                 reading (by clicking on the address book icon), it will first
  291.                 try to transfer the address in the "Reply-To: header.  If that
  292.                 is not present, it will use the "From:" header address.  YOU 
  293.                 CAN FORCE it to use the "From:" header address by pressing
  294.                 the SHIFT key when you click on the Address Book.
  295.  
  296.                 There was a limitation (or bug) in the address book routine
  297.                 which limited the number of addresses you could store in a 
  298.                 group to 255.  This limitation has been lifted.  You can now
  299.                 store up to 32,000 addresses in a group.
  300.  
  301.                 The address book screen has been modified to include a check
  302.                 mark item for group addresses to send only the group header in
  303.                 any message sent to a group rather than the email addresses of
  304.                 each member of the group.
  305.  
  306.                 When sending a message to a group, the messages will be sent 
  307.                 in groups of 50.  This is to allow for limitations in some
  308.                 SMTP servers that will not allow a message to be sent to more 
  309.                 then a difinitive number of recipients.  Most SMTP servers 
  310.                 should be able to handle 50 recipients at a time.
  311.  
  312.                 A busy pointer is now being displayed while a message is being
  313.                 read into the viewer.  You can not scroll the message display
  314.                 while this busy indicator is being displayed.
  315.  
  316.                 Attachments that are text attachments are generally shown in
  317.                 the message window itself with "SHOWN" indicated for the
  318.                 attachment in the Attachment requester.  The behaviour of 
  319.                 AEMail has been changed for messages with attachments 
  320.                 exceeding 5000 bytes.  Now, with such messages, the text 
  321.                 attachment will not be shown, but you would be able to save 
  322.                 it with the attachment requester.
  323.  
  324.                 The buttons to call up file requesters have been changed
  325.                 from "DIR" to "REQ".
  326.  
  327.                 Other minor corrections have been made including the 
  328.                 recognition of additional UUencoding formats.
  329.  
  330.  
  331. Version 1.11    Released October 14, 1996.  This version corrects some minor
  332.                 bugs as follows:
  333.  
  334.                 Corrected the installation script which incorrectly identified
  335.                 the "Amitcp:bin" directory.
  336.  
  337.                 Corrected bug that did not allow files in the file requester
  338.                 for the "stopnet" script in the Configuration screen.
  339.  
  340.                 Implemented the 9 character NickName for the address book that
  341.                 was suppose to be implemented in Version 1.10.
  342.  
  343.                 Made minor revisions in the printout formats for message lists
  344.                 and the address book.
  345.  
  346.                 Corrected the display of dates in the mm/dd/yy format when the
  347.                 year was beyond 2000.
  348.  
  349. Version 1.10    Released September 29, 1996.  The following bugs have been
  350.                 corrected (includes bugs corrected with Versions 1.04 a, b,
  351.                 and c.):
  352.  
  353.                 Corrected bug caused by multiple line SMTP responses.  This
  354.                 would result in a "hang" when trying to send messages.
  355.  
  356.                 Prevents a GURU (8000005 - Divide-By-Zero error) from
  357.                 occuring when AEMail was unable to determine the size of
  358.                 a message that was being retrieved from the POP Server.
  359.  
  360.                 Corrected a bug in which not enough memory was being
  361.                 allocated for error message requester displays.  This
  362.                 caused a GURU after the error message was displayed.
  363.  
  364.                 When a group address book entry had an actual UserID
  365.                 rather than a Nickname for one of it's addresses, the
  366.                 entire group was not sent.
  367.  
  368.                 A guru or freeze occurred when reading certain messages.
  369.                 These messages had an incomplete Content-Type: header.
  370.  
  371.                 Some requester windows had overlapping fields when a
  372.                 large Screen Text font was used.
  373.  
  374.                 If you tried to change your .signature file after you
  375.                 composed a message, you could not save your .signature
  376.                 file (the .signature file was left open).
  377.  
  378.                 If you composed a message without an ending Carriage
  379.                 Return and you added attachments, the attachments were
  380.                 not correctly recognized.  AEMail now forces a Carriage
  381.                 Return before attachments are added to the file.
  382.  
  383.                 Headers were not being printed when you printed a message.
  384.  
  385.                 Did not properly decode quoted-printable Content-Transfer-
  386.                 Encoding.
  387.  
  388.                 Times from 12 noon to 1 PM and from 12 midnight to 1 AM
  389.                 were incorrectly displayed.  Changed from 0:xx PM to
  390.                 12:xx PM and from 0:xx AM to 12:xx AM.
  391.  
  392.                 Changed install script so that it does not require AmiTCP:
  393.                 assign or TermiteTCP environmental variable at the Novice
  394.                 level.  If the AmiTCP: assign is not present, AEMail will
  395.                 be installed in a AEMAIL directory on your largest disk
  396.                 partition.  Also corrected some problems with install
  397.                 script.
  398.  
  399.                 Did not save default "Save Attachment Path" in AEMail.cnfg
  400.                 file.
  401.  
  402. Version 1.04c   Limited release on September 11, 1996.
  403.  
  404.                 Corrected bug caused by multiple line SMTP responses.
  405.  
  406. Version 1.04b   Limited release on September 4, 1996.
  407.  
  408.                 Corrected divide-by-zero error with progress indicator.
  409.  
  410. Version 1.04a   Limited release on September 2, 1996.
  411.  
  412.                 Added the time zone capability and corrected a number
  413.                 of bugs.
  414.  
  415. Version 1.03    Released August 28, 1996
  416.  
  417.                 Corrects bug in which clicking on a folder after the
  418.                 folder strip was slid to the side selected the wrong
  419.                 folder.  This occurred when more folders were present
  420.                 than could fit on the display.  The correction of this
  421.                 bug was considered important enough to immediately
  422.                 release this version.
  423.  
  424.                 Corrected a bug when messages that were not read were
  425.                 transferred to another folder.  The number of unread
  426.                 messages on the folder strip was incorrect.  Also, if you
  427.                 delete a message that was unread, it will reduce the
  428.                 unread count for that folder (the total message count
  429.                 still includes messages marked for deletion).  If you
  430.                 undelete a message that was never read, the unread count
  431.                 will increase.
  432.  
  433.  
  434. Version 1.02    Released August 25, 1996
  435.  
  436.                 Major bug found and corrected!  When sending email there
  437.                 was a problem with parsing the email addresses of the
  438.                 recipients of the message which could cause the system
  439.                 to freeze or guru.
  440.  
  441.                 Made minor changes to accomodate TCP/IP stacks other than
  442.                 AmiTCP, but which are compatable with AmiTCP.  Tested with
  443.                 TermiteTCP and Miami.
  444.  
  445.                 Added arguments when invoking AEMail from the shell.  This
  446.                 was to allow AEMail to be used as a "mailto" agent with
  447.                 several Amiga web browsers.  Tested with Voyager and AWeb.
  448.                 Consult AmigaGuide (MultiView) document for how to
  449.                 implement this feature.
  450.  
  451.                 Set default editor to C:ed.
  452.  
  453.                 Made changes to install script to create an easier
  454.                 installation.
  455.  
  456.                 Corrected bug when Text Attachments had lines longer than 100
  457.                 characters.
  458.  
  459.                 Changed Start Net and Stop Net menu items to provide for
  460.                 starting and stopping the network connection when your
  461.                 TCP/IP does not provide an automatic way to start or
  462.                 stop the Internet connection (signing onto your provider).
  463.                 See the AmigaGuide (MultiView) document on the TCP/IP
  464.                 parameters of the Configuration screen on how this function
  465.                 works.
  466.  
  467.                 (some of the above changes were in the 1.01 release)
  468.  
  469.  
  470. Version 1.01    Released August 5, 1996
  471.  
  472.                 Limited release incorporating some changes for TermiteTCP.
  473.  
  474.  
  475. Version 1.0     Released July 24, 1996.  First BETA release.
  476.  
  477.                 This is the first public version of AEMAIL released at the
  478.                 Sacramento Amiga Computer Club meeting.  The release includes
  479.                 the complete AEMAIL package including an installation script
  480.                 and documentation in AmigaGuide (MultiView) format.
  481.  
  482.  
  483. Version 0.06    Released July 8, 1996.   Last ALPHA release.
  484.  
  485.                 Implemented expanded configuration windows.
  486.  
  487.                 Added feature in which AEMAIL periodically checks for
  488.                 mail on your POP Server.
  489.  
  490.                 Added the "Iconify AEMAIL" feature and the menu item that
  491.                 supports it.
  492.  
  493.  
  494. Version 0.05    Released June 18, 1996
  495.  
  496.                 Added UUENCODED attachment support.
  497.  
  498.                 Added "Change Password" capability to main "Configure" window.
  499.  
  500.                 Added requirement that minimum configuration data be entered
  501.                 prior to starting AEMAIL.
  502.  
  503.                 Added QUEUED message check at program startup and when
  504.                 StartNet script is executed.
  505.  
  506.                 Added POP message and QUEUED message check at program
  507.                 termination.
  508.  
  509.  
  510. Version 0.04    Released June 2, 1996
  511.  
  512.                 Added the "About" menu item.
  513.  
  514.                 Added the delete folder menu item.
  515.  
  516.                 Implemented the printing of messages with your preferences
  517.                 printer.
  518.  
  519.                 Added "Progress" Windows to both the Send Message and
  520.                 Receive message processes.
  521.  
  522.                 AEMAIL now automatically recognizes whether it is connected to
  523.                 your Internet provider on program startup.
  524.  
  525.                 A Tool Type was added (AUTOCONNECT=YES) which automatically
  526.                 executes the StartNet script at program startup.
  527.  
  528.                 Added check to automatically to see if any messages are
  529.                 currently available on your POP server at program startup
  530.                 or when the StartNet script is executed.
  531.  
  532.  
  533. Version 0.03    Released on May 21, 1996
  534.  
  535.                 Added the "Startnet" and "Stopnet" menu items under a new
  536.                 "AmiTCP" menu and added the Tool Types to specify the calls
  537.                 for the STARTNET and STOPNET scripts.
  538.  
  539.                 Added the Configuration screen activated by the "Configuration"
  540.                 menu item under the PROJECT menu.
  541.  
  542.  
  543. Version 0.02    Released on April 20, 1996.
  544.  
  545.                 Added MIME support for attachments.
  546.  
  547.  
  548. Version 0.01    Released on March 20, 1996.  First ALPHA version.
  549.  
  550.                 This initial version could handle sending and retrieving text
  551.                 messages only; no attachment capability was present.  Certain
  552.                 features were not yet available and configuration was by
  553.                 Tool Types only.
  554.  
  555.  
  556.  
  557.